دليلك نحو بناء نظام 5۷٤٥‏ بسیط 


شيكة وني الالكترونة 


هذا الكتيب هو الإصدار الثاني لكتيب آخر أطلق منذ فترة على مدونة ديوبي المجانية على وورد 
تريس أها بعد انتاء شييكة ذيوبي الإلكرونية ققد تم اطلاق الإصدار الثاني تحت اسم الشيكة . 


creative 
COMMONS 


هذا الكتاب يخضع لرخصة الابداع العامة Aitibutlon-" __ . "Lrealiwve Com mon0S"‏ 
Il [1‏ » سمح الك بنسخ و تشر الكتاب :و عصال 


نسخة مشتقة مند تحت الشروط التالية : 


. النسبة : يجب عليك ان تنسب الكتاب بصفته الخاصة الى المؤلف أو المرخص‎ (BY) 


غير تجارى : لا يمكن استخدام هذا الكتاب لأغراض تجارية . 


ار يالل :ا قتف الاب ل وة أو بخ فلي تة تة ج غالا ي اا 


النهائى بنفس الرخصة التي حصلت عليها بهذا الكتاب . 


لا إعادة امخام أو توزيم جب علاك التا كد من :توضتج اشرو الوضكة اعلا للاخرين ٠‏ 
- من هذه الشروط یمن الا يعمل بھا اذا حضصلتث على تر خيض من ضاحب الملكية . 


انت مرخص لك بالاستخدام و كافة الحقوق الاخرى التى لا تتعارض مع الشروط الموضحة اعلاه . 


ما ھو MVC‏ ؟ 
هو نظام مستخدم في جميع أطر العمل ۴٣۳٣۷0۲)‏ و هو إختصار للتالي : 
Model —- View ¬ Controller )‏ ( 


ما هو إطار lلعJa framework‏ ¢ 
Framework‏ » أو إطار العمل وهو عبارة عن تطبيقات متكاملة تساعد المبرمج على أداء أعماله 
البرمجية بسرعة أكبر و جهد أقل مع توفر الإتقان والإحترافية في العمل . 


ماذا أحتاج لكي أبني هذا النظام ؟ 

يجب أن تتوفر لديك نسخة ۸5م و أنصحك باستخدام سيرفر W4۳9‏ ( تستطيع أن تحمله من الموقع 
ونی محا | کت ق م و ما فی لاک د و ا کن الدع اتل 
علی ۵۳| او قمت بتنصیب کل سیرفر على حدی بشکل يدوي ! . 


هذا الكتيب لن يعملك البرمجة بلغة ۸م لذلك يجب أن يكون لك خبرة سابقة في التعامل مع اللغة 
أو أن تغرف على الأقل اساستات برمة الكانناب و الورانة ‏ 


قم بانشاء مجلد جدید و سمیه كما تشاء ( أنا سوف اسميه ۷طس‌ه‌آك ) و أنشء فيه المجلدات التالية 
1. sعassاc‏ : نضع فيه الكائنات التي سوف يتم تضمينها في النظام . 
2. ersااcontro‏ : هذا المجلد سوق يجوي عنصر التحکم . 
3. udeاعn‏ : في هذا المجلد يتم تضمين الملفات الأساسية للنظام . 


حسئاً .. بعد أن ننشئ المجلدات التالية ننشئ في المجلد الرئيسي ¥طuهاك‏ ملف index.php‏ و 
نكتب فيه الكود التالي : 


<head> 

<title>plbi MVC</title> 

<meta http-equiv="Content-Language" content="ar-sy"> 

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" > 
</head> 


<?php 
include_once ("include/start.php"); 
2< 


حسناً بما أنك مبرمج ويب لديك خلفية لا بأس بها يفترض بك أن تعرف ما هو الكود المكتوب في 
الأاعلى بين وسمي 24ع" و إن كنت لا تعرف فهو كود يجعل الصفحة بترميز ۴-8ا لكي تتوافق مع 
اللغة العربية . 


يجب عليك تضمين الكود الخاص بالترميز في كل الصفحات التي سننشئها لاحقا لأنني 


أما في كود مم فإنك تلاحظ أننا قمنا بتضمين ملف أسميناه الملف الأساسي . 


ما هو الملف الأساسي ؟ 


هو ملف نقوم بتضمينه في بداية تشغيیل النظام لتحميل الخدمات الأاساسية و تعيين الخيارات 
الخاصة بالنظام مثلاً تحديد مستوى الأخطاء و التأكد من أن إصدار صم هو الإصدار الخامس فالنظام 


لا يعمل إلا على الإصدار الخامس و عدة أمور أخرى . 
حستاً للنشء الآن ملف م ٣م.٤إهاء‏ و الموجود كما هو واضح من الکود ضمن مجلد ٥dںuاcعہ؟‏ . 
اكتب الكود التالي : 
<?php‏ 
تحديد مستوى الأخطاء // 
error_reporting (E_ALL);‏ 
ممم التأكد من إصدار // 


أنت بحاجة |Jى>size=3 $php_version_error=' <b> <font face=tahoma color=990000‏ 
; '<ط/> >/nt<‏ مہم الإصدار الخامس من 


if (version_compare(phpversion(), '5', '<") == true) 4 die ($php_version_error); } 
// ثابت يحوي اختصار للسلاش‎ 

define (SH', '/'); 

استخراج المسار الحالي // 

$url = realpath(dirname(_ FILE_ ).SH.'"..'. SH). SH; 

define (URL, $url); 

?<> 


في البداية قمنا بتحديد مستوى الأخطاء على إظهار جميع الأخطاء ... يستفاد من هذه الخاصية في 
منع ظهور أخطاء معينة مثل أخطاء الاتصال بقاعدة البيانات مثلاً لديك ملف في موقعك يتصل بقاعدة 
البيانات و لسبب ما توقف سيرفر قاعدة البيانات فجأة في هذه الحالة سيظهر للزائر الخطاً عندما 
يدخل إلى موقعك أما إذا كنت قد حددت مستوى الأخطاء على منع إظهار الأخطاء الخاصة بقواعد 
البيانات سيظهر للزائر صفحة بيضاء بدون ظهور الخطأً و طبعاً هذا يفيد من الناحية الشكلية إضافة 
إلى الناحية الأمنية كما في بعض الأخطاء .. 


لنعد الآن إلى درسنا , في السطر الثاني نتأكد من أن إصدار مم هو 5مم أو إصدار أحدث و في 
حال كان غير ذلك نظهر رسالة الخطأً . 


أما بالنسبة لثابت الفاصلة سلاش فهو لاختصار كتابة المسار فبدل أن نكتب "/" نكتب 8© 


قى السطر القالي سكج مضار الملف:دو لاغظ ادام تامت القاهلة قي هدا السطر وقي 
السطر الثالي نضع مسار الملف قي ثابت ۴لا لاستخدامه عند الحاجة 


الآن اكتب في نهاية ملف مطم.٤١هاء‏ الكود التالي : 


function _ autoload($class_name) 4 
$filename = strtolower($class_name) . '.php'; 
$file = URL . 'classes' . SH . $filename; 

if (file_exists($file) == false) ¢ 

return false; 

٣ 
include ($file); 
‌ 


حسناً ما هذا الكود ؟ 


نحن في هذا النظام سوف نستخدم العديد من الكائنات ( الكلاسات) لأعمال مختافة 


حسناً في هذه الحالة بدلا من أن نضمن ملف الكلاس لكل كلاس نريد أن نستخدمه نستخدم الدالة 
Autoload‏ و هي إحدى الدوال الجديدة في 5مام 


ما هو عمل Jlدlلةö AutoLoad‏ ؟ 


لنفرض أننا قمنا بتعريف كائن جديد كالتالي : 


$gg = new gg; | 


حسناً الکائن ۲۷†كآوه۲ غير موجود فيقوم النظام تلقائياً باستدعاء الدالة Aut] ٥ad‏ و تمریر اسم 
الكائن لها , تضيف الدالة اللاحقة .صم إلى اسم الكائن (" لاحظ السطر الأول من الدالة ") بحيث 
يصبح اسم الملف مططم.إإاtكاأوعهء‏ في السطر الثاني تقوم الدالة بالبحث في مجلد كمsئهاع‏ عن 
الملف مطم.إإاstنوعإ‏ (" لاحظ استخدام ثابت المسار اRل‏ في السطر الثاني ") السطور المتبقية 
من الدالة تتحقق من وجود الملف فان كان موجوداً تضمن الملف و إن كان غير موجود تعيد قيمة 
فارغة» دالة جميلة أليس كذلك ! 


إلى هنا نكون قد انتهينا من الملف مطم.اstar‏ 
تقوم الأ نانشا كائن قتسخل بحم تضفه دأخل الكاننات الأخرك لتقل يانات التظاد 


أنشء الملف مطم.راإكاومء داخل المجلد ك#ءءهاع و اكتب بداخله الكود التالي : 


<?php 
class Registry 
private $vars = arrayÛ); 


ٍ 


function set($key, $var) 

if (isset($this->vars[$key]) == true) 4‏ 
'عفوا ... هذا المفاتح موجود مسبقا = $۵۲0۲ 
die($error);‏ 


$this->vars[$key] = $var; 
return true} 


ٍ 

function get($key) 4 

if (isset($this->vars[$key]) == false) 
return null; 


return $this->vars[$key]; 
ٍ 
function remove($var) 4 

unset($this->vars[$key]); 
ٍ 


2< 


في البداية قمنا بإنشاء إلكائن و تحديد خاصية ۷4۲۶ على شكل مصفوفة نقوم بتخزين البيانات داخل 
هذة المصفوفة و طا کا كائن تسضل بب أن تخو على دالة للاضاقة و الخذف و الاستكراج 


الدلة الأولى خ#ء هي لإضافة ( تخزين ) البيانات داخل الكائن و تحتوي على بارميتران هما , إم» 
۴‰ في السطر الأول تتحقق من ان المفتاح 6¥» غير مخزن سابقاً , في حال کان غير مخزن تقوم 
بتخزين المعلومات الجديدة و في حال كان موجود سابقاً تظهر رسالة خطا . 


الدالة التانية امو هي لإستخراج المعلومات المخزنة حسب المفتاح و تحتوي على بارميتر واحد هو 
k۷‏ , في السطر الاول نتاكد من ان المفتاح ¥€» موجود في حال كان موجود تستخرج المعلومات و 
في حال كان غير موجود تعيد قيمة فارغة 


الدالة التالتة م۷١٥٠‏ ٣٠ء‏ هي لحذق البيانات المخزنة و تحتوي على بارميتر واحد ايضاً هو ¥إه» و عملها 
واضح لا داعي للشرح 


حسنا الآن انتهينا من كائن التسجيل و طبعاً بما أن كائن التسجيل كما أشرنا سابقاً يتم تضمينه 
داخل الكائنات الأخرى لنقل بيانات النظام سنقوم بتعريفه ضمن ملف م٣م.٤١هاء‏ ليعمل عند بدء 
عمل النظام 


اكتب هذا الكود في نهاية ملف مط ٣م.t star‏ : 


$registry = new Registry; 


ما هو عمل كائن المسار ؟ 


يقوم الكائن باستقبال الطلب ( المسار ) من مستخدم الموقع , ثم يحلله و يقوم بتحميل صفحة 
العرض المناسبة 
هذا هو محتوی ملف مط طم.۲عt ru‏ الموجود ضمن مجلد کعsیھاc‏ 


<?php 

Class Router 

private $registry; 

private $path; 

function _ construct($registry) 


٤ 


$this->registry = $registry; 


ٍ 

function setPath($path) 

{ 

$path = trim($path, '/\\'); 
$path .= SH; 


if (is_dir($path) == false) { 

;athمp$.'‏ عفوا ... مجلد عناصر التحکم غیر موجود ' $P€۲۲0۵۲=‏ 
die($perror);‏ 

ر 
$this->path = $path;‏ 
function loading() ¢‏ 

$this->getController($file, $controller, $action); 
if (is_readable($file) == false) 
$this->error404('No - File"); 

1 
include ($file); 

$class = 'Controller_' . $controller} 

$controller = new $class($this->registry); 

if (is_callable(array($controller, $action)) == false) ¢ 
$this->error404('No - Action"); 

$controller-> $action); 


private function getController(&$file, &$controller, &$action) 4 
$route = (empty($_GET['route'])) ? " : $_GET['route']; 

if (empty($route)) { $route = 'index'; } 

$route = trim($route, '/\\'); 

$parts = explode(/', $route); 

$cmd_path = $this-> path; 


foreach ($parts as $part) 
$fullpath = $cmd_path . $part; 
if (is_dir($fullpath)) 4 
$cmd_path .= $part. SH; 
$cmd_path .= $part . SH; 
array_shift($parts); 

continue; 

1 
if (is_file($fullpath . '.php')) 
$controller = $part; 
array_shift($parts); 

break; 

ٍ 
ٍ 
if (empty($controller)) 4 $controller = 'index'; }; 
$action = array_shift($parts); 

if (empty($action)) { $action = 'index'; } 

$file = $cmd_path . $controller . '.php'; 


2< 


الآن إلى الشرح ... 

في البداية قمتا بانشاء خاضة التسیل التي ستخوی گائن التسجل الذى اتشاناة سابقا , الشطر 
التالي فيه خاصية المسار التي ستحتوي على المسار الكامل , الدالة الموجودة تحت خاصية المسار 
هي المشيد و تأخذ كائن التسجيل كمعطى لها و تقوم بتعيينه لخاصية التسجيل 


لمعرفة المزيد عن المشيد اذهب إJ” /http://www.php.net‏ 


الدالة 1غه ۴ء التي تقوم بتحديد المجلد الذي يحوي جميع صفحات العرض في البداية تأخذا الدالة 
البارميتر هم كمعطى لها تقوم بحذف العلامتين "/" و "ا" من المعطى ( طبعاً المعطى يقصد به 
اسم المجلد الذي يحتوي على صفحات العرض و سوف تفهم كيف نمرره للدالة بعد قليل ) , بعد ذلك 
تتاکد الدالة من ان المجلد موجود فان کان موجود تخزنه في خاصة المسار 9 إن لم یکن موجود تظهر 
رسالة خطأً . 


الآن نأتي إلى شرح الدالة eااە Cnt‏ etمو‏ في البداية نستقبل المتغیر ۲016۲ و نتأكد من أنه غير 
فارغ ثم نقسمه إلى أجزاء بوساطة الدالة مكهام×ه التي تحوله إلى مصفوفة , نستخدم بعدها 
حلقة تكرار تستخرج كل عنصر من المصفوفة على حدی و تتأکد من کونه مجلد فإذا کان مجلد تقوم 
بإاضافته إلى مسار صفحة العرض ( لاحظ إستخدام الثابت S١‏ ) و إذا كان ملف نخرج من المصفوفة و 
نتأكد من أن الملف موجود فعلاً و إذا لم يكن موجود نضع القيمة الافتراضية ×عمل١|ً‏ . 

بعد أن انتهينا من الدالة إهااهااetConو‏ و خزنا مسار صفحة العرض علينا تحميلها و طبعاً هذا عمل 
lلدlلö loading‏ 

في السطر الأول نقوم باستدعاء دالة الحصول على مسار صفجة lنعرض getController‏ 

تم نتأکد من ملف صفحة العرض موجود بالفعل فاذا کان موجود نقوم بتضمینه d٥‏ ںاC٤ہا‏ وإذا لم یکن 
نخرج رسالة خطا تم نقوم بتعریف الكلاس ڊlwuڊقة Controller‏ تم اسم الملف تم نقوم بعمل نسخة 
من الكلاس لاستخدامها في إخراج الوسيلة المطلوبة وبعد ذلك نقوم بالتأكد من أن الوسيلة المطلوبة 
هي دالة يمكن تنفيذها داخل كائن عن طريق إدخالهم على شكل مصفوفة تم تنفيذها وإذا لم تكن 
نخرج رسالة خطا . 


انتهينا الآن من ملف مطم.إعهutها‏ و لكي نستخدمه اكتب التالي في الصفحة مصطم.>deہi‏ 


تحميل كائن المسار// 
$router= new Router($registry);‏ 
$registry['router'] = $router ;‏ 


مسار مجلد صفحات العرض // 
$router->setPath(URL.'controllers');‏ 


$router->loading (); 


في البداية عملنا نسخة من كائن المسار ثم قمنا بتسجيله لیکون متغیر عام يمكن استخدامه فقي 
جميع الصفحات 


الس الا جود هما مل مانت اك و د و وة ا 
و السطر الأخير لتحميل صفحة العرض المناسبة . 


الآن ننشى الملف مطم.عمsهط_erااcontro‏ في مجلد ككعءهاع و الكائن هذا سيكون هو الأب 
لجميع كائنات صفحات العرض التي قد تنشتها لاحقا 


اكتب الآن الكود التالي : 


<?php 

Abstract Class Controller Base ¢ 
protected $registry; 

function _ construct($registry) 4 
$this->registry = $registry; 

ل 


abstract function index(); 


٣ 


?<> 


في البداية يقوم بعمل نسخة عن كائن التسجيل حتى لا نقوم بنسخها في كل صفحة عرض و إنما 
ستعمم عن طريق الوراثة و قمنا بجعله ا٤هإ٤ءطه‏ و كذلك أنشأنا الوسيلة ×هك١أً‏ و جعلناها 


abstract‏ و فائدة هذه الوسيلة as۵ ٤٤‏ هو لضمان احتواء جميع كائنات صفحات العرض على 
وسيلة ×عind‏ . 


لننشئ الآن أول صفحة عرض , قم بإنشاء الملف مطم.×ملہ¡ في مجلد ۶٣eاام cont‏ و اكتب 
التالي : 


<?php 

Class Controller_Index Extends Controller_Base ¢ 
function index() 

echo '<font col0r=99000<> محمد ديوب يرحب بكم‎ >/font< '; 


٣ 


}?< 


لقد قمنا بإنشاء أول كائن عرض , لاحظ في السطر الأول قمنا بكتابة _×1"4۵ بعد ۵۲ااه 0٣‏ وهو 


اسم عنصر التحكم الذي يجب أن يكون نفسه اسم ملف صفحة العرض و من تم أنشأنا الوسيلة 
index‏ 


استعرض الآن النظام ستجده يعمل بكفاءة و لأي مشاكل أنا جاهز للمساعدة 


كان هذا نظام بسيط جداً جداً و لكن الفائدة منه هو فهم طريقة عمل هذه الأنظمة » أتمنى أن أكون 
قد آفدت و هي الغاية من هذا الكتيب و السلام عليكم و رحمة الله و بركاته 
محمد دیوب 


تم إنشاء هذه الوثيقة باستخدام برنامج We‏ وor.عfic؟en0fم0‏ المفتوح المصدر و تم تحويله إلى 
ملف كم بواسطة البرنامج ايضاً . 


المراحع : 


درس أجنبي مترجم و بعض صفحات المنتديات من هنا و هناك طبعاً مع بعض التصرف و التوسع في 
الشرح ... 


